Verifies the value of a window or control property matches an expected value. If the values do not match, the script fails or continues and displays a message in the Errors pane.
Checkpoints can validate both visual and non-visual properties. For example, you can check that a window includes specific title bar buttons. See Using Checkpoints.
Note: Use the OCRCheckpoint statement to verify graphical text against an expected value.
Syntax
Checkpoint("PropertyName", ExpectedValue, FailureBehavior, "Warning")
Arguments
| Argument | Description |
|---|---|
| PropertyName | Name of the property to check. You can view a list of all properties captured for the window or control when it was added to the application repository in the Properties dialog box. See Modifying window and control properties. |
| ExpectedValue | Value to check. |
| FailureBehavior | Optional failure behavior. True stops the script if the checkpoint fails. False displays a warning and continues playback. If not specified, True is used. |
| Warning | Optional message to display in the Errors pane and run report when checkpoints fail. |
Keyword View notes
The property and value to check is displayed as ("Property" = "Value") in the Information column.
Supported objects
Browser, Button, Calendar, Cell, CheckBox, ColumnHeader, ComboBox, ContextMenu, Control, DateTimePicker, EditBox, Grid, HTMLElement, HTMLLink, HTMLTable, Image, Item, Label, Link, ListBox, ListView, Menu, NavigationField, PopupMenu, ProgressBar, RadioButton, Row, RowHeader, ScrollBar, Slider, SpinBox, SubItem, Tab, TabBar, ToolBar, Tree, Window
Example
Window("WysiCorp Login").Button("buttonLogin").Checkpoint("Text", "Login", True, "Button text is incorrect")